home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 007a / lcpanl24.zip / LCPANEL.DOC < prev    next >
Text File  |  1991-10-15  |  11KB  |  223 lines
  1.  
  2.  
  3.  
  4.                             OPERATION AND INSTALLATION OF
  5.                                        LCPANEL
  6.                      A CONTROL PROGRAM FOR THE LOGICAL CONNECTION
  7.                               PERIPHERAL SHARING SYSTEM
  8.  
  9.                 (Logical Connection is a registered trademark of Fifth
  10.                                  Generation Systems)
  11.  
  12.  
  13.              LCPANEL is offered as is, with no warranty as to fitness or
  14.                    purpose.  Any user assumes all risk for its use.
  15.  
  16.  
  17.              ********************** LICENSE ****************************
  18.  
  19.              LCPANEL is copyright (C) 1988,1989,1991 by A. J. McPhate Jr.
  20.  
  21.           All persons or organizations, other than employees of Fifth
  22.           Generation Systems or Fifth Generation Systems itself, are
  23.           granted a license to use LCPANEL in any manner they wish, so
  24.           long as they understand that this software is offered
  25.           without any warranty whatsoever, that no consideration or
  26.           fee may be charged for this software, and this software may
  27.           not be distributed in conjunction with any product for which
  28.           a fee is charged.
  29.  
  30.           Employees of Fifth Generation Systems and computers owned by
  31.           Fifth Generations Systems may not use this product at all.
  32.           They may provide it at no charge to customers who request
  33.           it, but it cannot be distributed with the Logical Connection
  34.           product.
  35.  
  36.           Operators of electronic bulletin board systems are encouraged to
  37.           post LCPANEL for downloading by their users, subject to the above
  38.           conditions.
  39.  
  40.           *****************************************************************
  41.  
  42.           DESCRIPTION
  43.           =================================================================
  44.           Now that that's out of the way, we can get down to business.  If
  45.           you have used the Logical Connection peripheral sharing system,
  46.           you know that it is generally a good system.  However, one of its
  47.           weak links is its control software.  LCPANEL is a replacement for
  48.           POPLC, the program that comes with the Logical Connection.
  49.           (POPLC is also a registered trademark of Fifth Generation
  50.           Systems).
  51.  
  52.           If you want a quick rundown of the shortcomings of POPLC and what
  53.           LCPANEL does to solve them, here it is:
  54.  
  55.           POPLC is FAT: it occupies 20192 bytes of precious ram when
  56.           loaded.  LCPANEL only takes up 5648 bytes;
  57.  
  58.           POPLC is RUDE: if you forget where you are and pop-up POPLC while
  59.           in graphics mode, you will have your RAM scrambled.  LCPANEL will
  60.           not pop-up in graphics mode;
  61.  
  62.           POPLC has a limited vocabulary: you can only store four control
  63.           sequences of 44 characters in POPLC.  LCPANEL lets you store up
  64.           to ten control sequences of up to 60 characters each.  You can
  65.           even give each user his or her own special control sequences;
  66.  
  67.           POPLC requires more keystrokes: it forces you to send one control
  68.           string per pop-up session.  LCPANEL lets you send multiple
  69.           control strings in a single pop-up session;
  70.  
  71.           POPLC is dirty: its screen contains a bunch of garbage you don't
  72.           need to see, like eight peripherals when you only have two.
  73.           LCPANEL will limit the number of devices to whatever you say.  If
  74.           you only have two, then two is what you will see;
  75.  
  76.           POPLC has limited hot-keys: LCPANEL will let you assign any
  77.           keycode and scan mask as the hot-key;
  78.  
  79.           POPLC won't let you use all your ports: if you want to send data
  80.           out your parallel port thru a parallel/serial converter to a
  81.           serial port on the Logical Connection, POPLC assumes you goofed
  82.           up and won't let you.  LCPANEL lets you use any port to talk to
  83.           any port.  After all, we know we only get two COM ports, but we
  84.           get three LPT ports.  How many of you have three parallel devices
  85.           on your PC?
  86.  
  87.  
  88.           INSTALLATION
  89.           ===============================================================
  90.           LCPANEL is installed similar to the way POPLC is installed.  The
  91.           CONFIG.LC file must reside in the same subdirectory as LCPANEL,
  92.           as does the new user command file, COMMANDS.LC.  The command line
  93.           parameters are not case sensitive and may be entered in any
  94.           order.  The quick summary of usage is:
  95.  
  96.           lcpanel pc=aaad lc=a [kc=ddd sm=dd od=d]
  97.  
  98.           The parameters are described in detail below.  The first two
  99.           parameters are REQUIRED!  The remaining parameters are optional,
  100.           but I recommend you specify od, as it sure makes things look
  101.           cleaner.
  102.  
  103.           In detail, the parameters are:
  104.  
  105.           pc=aaad
  106.  
  107.           which represents the port on the PC used to communicate with the
  108.           Logical Connection.  The 'aaa' is 'lpt' or 'com' and 'd' is '1',
  109.           '2', or '3', as the case may be.  There is no default.
  110.  
  111.           lc=d
  112.  
  113.           where 'd' is the port number on the Logical Connection that the
  114.           PC is plugged into, 0 thru 7.  There is no default.
  115.  
  116.           kc=ddd
  117.  
  118.           representing the hot-key that pop-ups LCPANEL. The 'ddd' is a key
  119.           scancode in decimal.  ALL THREE DIGITS MUST BE USED! (so 99 is 099)
  120.           The default is 038, for L.  The scan codes are:
  121.  
  122.           001    esc  011   0    021   y    031   s    041   `
  123.           002    1    012   -    022   u    032   d    042   lshft
  124.           003    2    013   =    023   i    033   f    043   \
  125.           004    3    014   bs   024   o    034   g    044   z
  126.           005    4    015   tab  025   p    035   h    045   x
  127.           006    5    016   q    026   [    036   j    046   c
  128.           007    6    017   w    027   ]    037   k    047   v
  129.           008    7    018   e    028   cr   038   l    048   b
  130.           009    8    019   r    029   ctl  037   ;    049   n
  131.           010    9    020   t    030   a    040   '    050   m
  132.  
  133.           051   ,     061   f3   071  home  081  pgdn  091
  134.           052   .     062   f4   072  up    082  ins   092
  135.           053   /     063   f5   073  pgup  083  del   093
  136.           054 rshft   064   f6   074  g-    084        094
  137.           055  g*     065   f7   075  left  085        095
  138.           056  alt    066   f8   076  g5    086        096
  139.           057  spc    067   f9   077  right 087        097
  140.           058  caps   068   f10  078  g+    088        098
  141.           059  f1     069  numlk 079  end   089        099
  142.           060  f2     070  scrlk 080  down  090        100
  143.  
  144.           sm=dd
  145.  
  146.           representing the shift key status of the hot-key.  The 'dd' is a
  147.           shift mask representing the status of modifier keys such as alt,
  148.           ctrl, or both.
  149.  
  150.           The shift mask is equal to the sum of each keys value:
  151.  
  152.           right shift    1
  153.           left shift     2
  154.           ctrl           4
  155.           alt            8
  156.  
  157.           so for a hot key of ctrl-alt-L, you would set kc=038 and sm=12
  158.           (24 = 4 + 8).  The default hot-key is Alt L.
  159.  
  160.           od=d
  161.  
  162.           which represents the number of output devices you have on the
  163.           system.  If you want to switch between the first three devices,
  164.           set od=3.  Default is 8.
  165.  
  166.           USER COMMANDS
  167.           ===============================================================
  168.           LCPANEL does not use the control sequences imbedded in the
  169.           CONFIG.LC file.  This lets the user configure different commands
  170.           or add commands without reconfiguring the Logical Connection.
  171.           Control sequences for user commands are stored in a file called
  172.           COMMANDS.LC located in the same directory as LCPANEL.COM and
  173.           CONFIG.LC.  It contains up to ten lines of up to 80 characters
  174.           each.  The first twenty characters of each line are that
  175.           command's name and the remaining 60 characters are the command
  176.           string itself.  Escape sequences and other unprintable characters
  177.           are represented by \ddd where the ddd is the decimal value of the
  178.           character.  Escape is \027.  An example file is included for your
  179.           use and study.  You must use a straight text processor that does
  180.           not expand or compress tabs when building this file.
  181.  
  182.           USING LCPANEL
  183.           =================================================================
  184.           LCPANEL is very intuitive and easy to use.  You can probably
  185.           figure out LCPANEL just by looking at it and playing with it, but
  186.           for those of you who want to know what to expect:
  187.  
  188.           Del     immediately clears the buffer.
  189.           ?       puts the configuration data in the message window.
  190.           Space   scrolls the output device window.
  191.           Esc     exits without doing anything.
  192.           Enter   exits and executes whatever you have indicated you want
  193.                   done.
  194.           F1-F10  toggle a user command.
  195.  
  196.           You may have more than one command toggled when you exit.  They
  197.           will be sent in sequence.  They will be sent *after* the device is
  198.           switched, if you have indicated a new device, so you can switch
  199.           devices and configure them all at one session.  Commands toggle off
  200.           as well as on.  The window at the bottom of the pop-up reports any
  201.           errors that might occur with the communications.
  202.  
  203.           VERSION HISTORY
  204.           =================================================================
  205.           1.00- Original shareware release.
  206.           1.01- Increased intra-message time delay for better performance
  207.                 with plotters.
  208.           2.00- Fixed a bug in the time delay technique and removed redundant
  209.                 bidirectional switch string that was causing problems with
  210.                 plotters. Corrected a bug with the command file parser that
  211.                 made it incompatible with some editors.  Removed port
  212.                 configuration data from the screen and allowed it to be
  213.                 accessed via the "?" key. Corrected errors in documentation.
  214.           2.10- Fixed a bug with the CGA compatibility.  Now works on CGA
  215.                 systems.  Changed default hot key to same as POPLC, Alt L.
  216.                 Fixed documentation errors about shift masks.
  217.           2.20- Restored the redundant bidirectional switch string to maintain
  218.                 compatibility with old version of POPLC.
  219.           2.40- Removed the section of code that tests for port 0 of the
  220.                 configuration file, allowing users to set the lc=0 value.
  221.                 Removed the requirement for licensing and license fee.
  222.                 The final version of LCPANEL.
  223.